package com.hui.qiniucloud.service;

import com.hui.qiniucloud.entity.User;
import com.hui.qiniucloud.dto.*;
import com.baomidou.mybatisplus.extension.service.IService;

import java.util.List;

/**
 * <p>
 * 用户表 服务类
 * </p>
 *
 * @author huihui
 * @since 2025-09-28
 */
public interface IUserService extends IService<User> {

    /**
     * 用户注册
     * @param request 注册请求
     * @return 用户响应信息
     */
    UserResponse register(UserRegisterRequest request);

    /**
     * 用户登录
     * @param request 登录请求
     * @param clientIp 客户端IP
     * @return 登录响应信息
     */
    UserLoginResponse login(UserLoginRequest request, String clientIp);

    /**
     * 更新用户信息
     * @param userId 用户ID
     * @param request 更新请求
     * @return 更新后的用户信息
     */
    UserResponse updateUserInfo(Long userId, UserUpdateRequest request);

    /**
     * 修改密码
     * @param userId 用户ID
     * @param request 密码修改请求
     */
    void updatePassword(Long userId, UserPasswordUpdateRequest request);

    /**
     * 根据用户ID获取用户信息
     * @param userId 用户ID
     * @return 用户响应信息
     */
    UserResponse getUserInfo(Long userId);

    /**
     * 根据用户名获取用户信息
     * @param username 用户名
     * @return 用户实体
     */
    User getUserByUsername(String username);

    /**
     * 检查用户名是否存在
     * @param username 用户名
     * @return 是否存在
     */
    boolean isUsernameExists(String username);

    /**
     * 检查邮箱是否存在
     * @param email 邮箱
     * @return 是否存在
     */
    boolean isEmailExists(String email);

    /**
     * 检查手机号是否存在
     * @param phone 手机号
     * @return 是否存在
     */
    boolean isPhoneExists(String phone);

    /**
     * 搜索用户
     * @param keyword 关键词
     * @return 用户列表
     */
    List<UserResponse> searchUsers(String keyword);

    /**
     * 获取所有用户
     * @return 用户列表
     */
    List<UserResponse> getAllUsers();

    /**
     * 禁用/启用用户
     * @param userId 用户ID
     * @param status 状态 0-禁用 1-启用
     */
    void updateUserStatus(Long userId, Integer status);
}
